Skip to content

docs(roadmap): 形显于框,图预成竹 · Add detect-only exit and ORT model format …#21

Merged
eric8810 merged 1 commit into
mainfrom
docs/roadmap-detect-only-ort
Jul 21, 2026
Merged

docs(roadmap): 形显于框,图预成竹 · Add detect-only exit and ORT model format …#21
eric8810 merged 1 commit into
mainfrom
docs/roadmap-detect-only-ort

Conversation

@eric8810

@eric8810 eric8810 commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

动机

补 roadmap 两处经评估后值得纳入、且此前未明确规划的低成本技术点:

  1. 检测-only 出口——把 Core 中本就独立的 detection stage 暴露为公共入口,零新增算法。
  2. ORT 模型格式——作为 Perf-1B 的一个 session 创建成本优化子项,属无分发矩阵扩大的同类收益。

改动

N1 新增 5.4 检测-only 出口(原 5.4–5.7 顺延为 5.5–5.8)

  • 仅运行 detector,输出与 line.box 相同的 pageSpace quad 契约,不触发 recognition
  • 可选返回 index 对齐的 PNG crop
  • 明确与 ROI 的区分:ROI 是输入侧区域约束,detect-only 是输出侧能力裁剪
  • 明确不是 Layout 的替代:只给原始检测框,不附 region label
  • 放在 N1 而非 N4 的依据:检测框是未来 OCR line 与 Layout region 共享的中间产物,N4 在此基础上加分类与编排,不重复跑检测——所以它同时是业务入口和 N4 前置基础设施

Perf-1B 新增第 3 条(原 3/4/5 顺延为 4/5/6)

  • 评估 bundle 采用 ONNX Runtime ORT 格式(FlatBuffers 预优化图)
  • 按 magic 识别格式,对已预优化的 ORT 图跳过/降低 GraphOptimizationLevel
  • 收益场景:cold start、容器/serverless 频繁重建 session、CLI 每次进程调用
  • Gate:与现行 .onnx 路径输出 parity 验证,不放宽质量与确定性门禁;加速以可重放测量记录

不在本次范围

  • 实际代码改动(bundle 换格式、detect-only API 实现)按 roadmap 节点节奏推进,本次只锁定规划
  • 字典切换 / 语言预设:评估后判定为非空白(默认 v6 统一模型已覆盖),不纳入

Checklist

  • The change is focused; relevant tests were added or updated when behavior changed, otherwise this is N/A.
  • Documentation and CHANGELOG.md were updated for user-visible changes, otherwise this is N/A.
  • No credentials, private OCR inputs, generated build trees, or unrelated artifacts are included.

@eric8810
eric8810 merged commit 3e079ab into main Jul 21, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant